home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1997 January / Software of the Month Club 1997 January.iso / pc / dos / sri / edu / stefi / stefi.doc < prev    next >
Encoding:
Text File  |  1995-12-31  |  11.6 KB  |  234 lines
  1.                    =========================================
  2.                                      STEFI
  3.                    =========================================
  4.  
  5.                        GRAPH EDITOR AND ANALYSER PROGRAM
  6.                                   Version 1.0a
  7.  
  8.                        Copyright (c) 1995 by Bálint Tóth
  9.  
  10.                                  DOCUMENTATION
  11.  
  12.  ============================================================================
  13.  
  14.   Contents
  15.   --------
  16.   1. Introduction
  17.   2. Registration and Distribution Information
  18.   3. Getting Started
  19.   4. How to Get Online Help
  20.   5. Constraints
  21.   6. Changes from Version 1.0
  22.   7. Other Programs Available from the Same Author
  23.   8. Contacting the Author
  24.  
  25.   1. Introduction
  26.   ---------------
  27.     STEFI is a Graph Editor and Analyser Program
  28.     You can edit, save, view graphs and analyse them. Report can be
  29.     generated about many details, e.g. weights, matrices, components,
  30.     Prufer code, min. cost path and tree, excentricity, center,
  31.     topologic order, strong components and more.
  32.  
  33.     The package is being distributed as a cheap SHAREWARE. See next chapter
  34.     for registration and distribution information.
  35.  
  36.     The program runs on any IBM PC or compatible computer, under
  37.     MS-DOS 3.30 or newer operating system. It needs about 400 kbytes of free
  38.     (conventional) memory. The presence of a mouse can be helpful but not
  39.     mandatory.
  40.  
  41.   2. Registration and Distribution Information
  42.   --------------------------------------------
  43.     The program package is being distributed as SHAREWARE. You may use the
  44.     program for a period of 14 days, after which you must either register the
  45.     program with the author or stop using it.
  46.     A registration form is included to help with the registration process.
  47.     To register the program, send the registration form and send $10 in U.S.
  48.     funds by postal money order to:
  49.  
  50.             Bálint Tóth
  51.  
  52.     Mail:   Kabar u. 7. V. 27.
  53.             H-1039 Budapest
  54.             HUNGARY
  55.             Europe
  56.  
  57.     The registration includes free of charge registration of all available
  58.     upgraded versions of this software that are released within 12 months
  59.     after you have sent your registration form. It doesn't mean sending of
  60.     update disks automatically. For financial reasons updating by FTP, WWW,
  61.     or E-mail are preferred.
  62.  
  63.     The distribution files of the program package are:
  64.         FILE_ID .DIZ     Short program description
  65.         STEFI   .DOC     Program documentation/manual
  66.         REGISTER.FRM     Registration form that can be printed
  67.         STEFI   .EXE     Stefi - the executable program itself
  68.         STEFI   .TVH     Online binary helpfile (needed by STEFI.EXE)
  69.         DAG     .GRF     Sample graph file
  70.         DISTANCE.GRF     Sample graph file
  71.         FOREST  .GRF     Sample graph file
  72.         FULL    .GRF     Sample graph file
  73.         PRUFER  .GRF     Sample graph file
  74.         STRONGC .GRF     Sample graph file
  75.  
  76.     The program package, which MUST include all the above files may be freely
  77.     copied and distributed. These files may be re-archived to better suit a
  78.     given distribution system, but the files may not be modified in any other
  79.     way. No distributor may charge more than $5 for the distribution of this
  80.     program, and that fee in no way reduces the shareware registration fee
  81.     owed to the author by the user. Uploading to BBSs or FTP sites or
  82.     distribution on CD-ROMs are accepted and encouraged.
  83.  
  84.     SPECIAL OFFER FOR HUNGARIAN USERS:
  85.     Hungarian users may optionally register the program in Hungarian funds
  86.     (Forints) as well. You'll need to send only the discounted amount of
  87.     500 HUF (Forints).
  88.  
  89.   3. Getting Started
  90.   ------------------
  91.     STEFI uses Turbo Vision as a user interface, what is well-known for its
  92.     simple usage. On the top of the screen there is a menu bar. Click with the
  93.     mouse on any item to access a pull-down menu and then click on a menu item
  94.     to select it. You can also press F10 to access the menu bar and cursor
  95.     keys and Enter to navigate.
  96.     On the right side of the menu bar the filename of the currently opened
  97.     graph can be seen (or <untitled> if it hasn't been saved yet).
  98.     The bottom of the screen is the status bar which lists some of the
  99.     available hotkeys or a short description of the highlighted menu item.
  100.     The largest part of the screen (called desktop) is empty at startup. Later
  101.     the results of a graph analysis appears here in a separate window. You
  102.     can browse the result with the cursor keys, Page Up/Down or with the
  103.     vertical scroll bar on the right side of the window. You may have several
  104.     windows opened at the same time, you can move, resize or arrange them.
  105.  
  106.     To see quickly, how STEFI works, press F3 or select Open from the
  107.     Graph menu. Select any saved graph (graph files have .GRF as extension)
  108.     and click on Ok. Press F7 or select Graph|View to see the graph. Press
  109.     any key to bring back the user interface then press F9 or select
  110.     Graph|Report to analyse it. A dialog box appears where you can choose what
  111.     information will be put in the report. The default is all available
  112.     information. Click on Ok and the report will be displayed on the screen
  113.     and saved to the disk at the same time. Now press F4 or select Graph|Edit
  114.     to modify the graph and re-create the report.
  115.     See the online documentation for more details about creating opening,
  116.     viewing, editing, saving and analysing graphs, moving resizing, arranging
  117.     windows, using dialog boxes, etc.
  118.  
  119.   4. How to Get Online Help
  120.   -------------------------
  121.     STEFI contains context-sensitive online help. To get help on any menu item
  122.     or dialog box, simply press F1. A help screen appears describing the
  123.     current menu item or dialog box.
  124.     You can also access the help system via the Help menu. Choose the Contents
  125.     menu item as a starting point. To get help on using the help system itself,
  126.     choose the Help on Help menu item. Most of the help screens contains
  127.     links to other help screen. To jump to the referenced screen, just click
  128.     the portion of text with different color.
  129.     Also note, when a menu item is highlighted, the status bar (at the bottom
  130.     of the screen) gives a short description of that menu item.
  131.     The graph editor has no help screen, but all valid key-kombination is
  132.     listed on the left side of the screen.
  133.  
  134.   5. Constraints
  135.   --------------
  136.     Currently the program supports graphs only with a limited size. The
  137.     upper limit of nodes is 26, mainly because it is convenient to label
  138.     a node by a single letter. This limit could be increased (and possible
  139.     will be increased in a future version) but I find it big enough for
  140.     practical situations, because editing larger graphs and seeing analysis
  141.     results of larger graphs are not easy.
  142.     Only one edge is allowed between two nodes. (Or two in case of a directed
  143.     graph: one in both directions.) No single loop (an edge with the same node
  144.     as start and endpoint) is allowed.
  145.     Here are the constraints:
  146.         Maximum number of nodes: 26
  147.         Maximum number of edges: 26 * 25 (The number of maximum possible edges
  148.                                           in a full directed 26-node graph.)
  149.         Maximum number of circles: 100
  150.         Maximum number of cuts: 100
  151.  
  152.   6. Changes from Version 1.0
  153.   ---------------------------
  154.    Version 1.0a (released on 15 November, 1995)
  155.    - Fixed a minor bug which occured when reporting the minimal cost pathes
  156.        of graphs with more then 10 nodes.
  157.    - Another sample graph was added (FULL.GRF).
  158.    - The documentation has been also slightly changed. (See Chapter 5 and 6.)
  159.  
  160.   7. Other Programs Available from the Same Author
  161.   ------------------------------------------------
  162.     There are some other shareware and freeware programs available from
  163.     the same author:
  164.       - BALI'S CALC  - a Simple Scientific Calculator Program with
  165.                         ( ) x^y x! Pi Deg Rad Sin & Arcs, Ln Exp Mem
  166.                         Ran SCI BackSpace & more. DOS text mode,
  167.                         keyboard and/or mouse control (SHAREWARE).
  168.       - FORMULA v2.0 - a Mathemathical Expression Evaluating Program
  169.                         with about 100 - 100 built-in contants and functions,
  170.                         and a constant and function editor, where you can
  171.                         define and save your own set. (SHAREWARE)
  172.       - C64ASM v1.1  - a Commodore 64 (6510) Assembler Package for PC
  173.                         C64ASM is an assembler for 6510 CPU, but runs on PC
  174.                         Supports local & global symbols, math.expressions,
  175.                         .IF, .GOTO, .INCLUDE, .INCBIN, detailed report & more.
  176.                         C64DISA is a disassembler with hexa/ascii dumps.
  177.                         BAS2TXT converts a tokenized CBM file to textfile.
  178.                         PRG, T64 and P00 file format support. (SHAREWARE)
  179.       - C64PROGS     - Two Commodore 64 programs written in pure assembly.
  180.                          - Bali's Sprite Designer 4.0
  181.                          - Bali's Character Editor 2.0
  182.                         In T64 tape file format. A C64 emulator (or a real C64)
  183.                         is required. (FREEWARE)
  184.       - C64SRC       - The assembly source files of C64PROGS in T64 tape file
  185.                         format. C64ASM v1.1 (or PROFI-ASS 64 on a real or
  186.                         emulated C64) is needed to compile them. (FREEWARE)
  187.       - DOSINFO v1.3 - Information about dos, disks and more (FREEWARE)
  188.       - PRIMES       - List of prime numbers and prime factorization (FREEWARE)
  189.       - ASCII TEXTFILE MASTER  - A commandline-driven ascii textfile processor
  190.                         with margins, automatic page breaks, header & footer,
  191.                         justify, include files, symbolic defines, print merge
  192.                         and more. Manual only in Hungarian. (FREEWARE)
  193.  
  194.     Most of these programs are also available on some anonymous FTP sites:
  195.       - Garbo:   ftp://garbo.uwasa.fi/pc/
  196.       - SimTel:  ftp://ftp.coast.net/SimTel/msdos/      (and many mirrors)
  197.     Or on the World Wide Web at
  198.         http://indigo2.vsz.bme.hu/bali/download.htm
  199.     The newest update of this and my other programs are earliest available
  200.     on the WWW site above.
  201.     If you don't have FTP or WWW access and you are still interested in
  202.     getting these programs, contact me by mail or e-mail.
  203.  
  204.   8. Contacting the Author
  205.   ------------------------
  206.     I am always glad when receiving any feedbacks about my programs.
  207.     If you are satisfied :-), please let me know.
  208.     If you find it useless :-(, poor or disappointing, or just made a
  209.     much better one, please don't hesitate to write me that, too.
  210.     If you find any bugs :-(, please report them to me.
  211.     If you have any suggestions for further improvements, I will
  212.     appreciate them as well.
  213.     If you are interested in getting the source code of this or other
  214.     programs made by me, contact me for details.
  215.  
  216.     Contact me at:
  217.  
  218.             Bálint Tóth
  219.  
  220.     Mail:   Kabar u. 7. V. 27.
  221.             H-1039 Budapest
  222.             HUNGARY
  223.             Europe
  224.  
  225.     Phone:  (+36)-1-1873943 (This is a Hungarian call (GMT+0100) )
  226.  
  227.     E-mail: s4078tot@sun10.vsz.bme.hu
  228.               This e-mail address is valid only to June, 1997
  229.               (It is not frequently checked during Summer holidays)
  230.  
  231.     If you have access to the World Wide Web (WWW), don't forget to visit
  232.     my personal home page at the URL:
  233.             http://indigo2.vsz.bme.hu/bali/
  234.